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UNITED STATES DEPARTMENT OF COMMERCE 
National Bureau of Standards 

Washington, D.C. 20234 




1976 September 3 


MEMORANDUM FOR FIPS Points of Contact . 

From: Harry S. White , Jr. J.U'£ 

Associate Director for ADP Standards 

Subject: October 12, 1976 Symposium on Documentation of Computer 
Programs and Automated Data Systems 




On October 12, 1976, the National Bureau of Standards and the U.S. 
Civil Service Commission are jointly sponsoring a symposium to 
introduce the Federal Government ADP community to the concepts and 
guidelines which have been made available through the recent 
publication and issuance of FIPS PUB 38, Guidelines for Documentation 
of Computer Programs and Automated Data Systems . 

The planning, design, development, and implementation of computer 
programs and automated data systems (software) represent a consider- 
able investment of resources. To maximize the return of this 
investment, and to provide for cost-effective operation, revision, 
and maintenance, sufficient documentation is needed at each phase 
of the software development life cycle. FIPS PUB 38 has been 
developed to provide government-wide guidelines in response to 
that need. 

The symposium will be organized into a plenary session followed by 
three concurrent panel sessions which will focus on the aspects 
relative to management, operations and staff. 

Details of the symposium are provided in the enclosed brochures. 
Please distribute these at the earliest possible date to those 
individuals within your agency who would have an interest in 
attending. 

Additional copies of the enclosed brochures may be obtained by 
calling Mrs. Beatrice Marron at NBS on 921-3491. 
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DOCUMENTATION OF 
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sponsored by 

Federal Information Processing Standards 
Task Group # 14 (Documentation for Information 
Processing System) National Bureau of Standards 
U. S. Department of Commerce 

in conjunction with 

The ADP Management Center 

U. S. Civil Service Commission 
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8:30 a.m. Registration and coffee Session A - Executives, User Managers, Project Managers 


9:30 a.m. Welcome and general introduction 
Red Auditorium 

M. Zane Thornton, Deputy Director 

Institute for Computer Sciences and Technology 

National Bureau of Standards 

9:50 a.m. Why Have Documentation Standards and 
Guidelines? 

The Honorable Theodore D, Puckorius 
Commissioner, Automated Data and Telecom- 
munications Service 
General Services Administration 

10:15 a.m. Philosophy of FIPS PUB 38 

Introduction James Gillespie 

Life Cycle Concept and 
Document Types Roy Young 

Flexibility Provisions and 

DocumentType Selection Robert Hegland 

Content Guidelines TomKurihara 

Summary James Gillespie 

11:15 a.m. Description of afternoon sessions 

Mark Silverman 
U.S. Geological Survey 

11:20 a.m. Coffee 

11:40 a.m. Parallel Sessions A, B, and C 

Presentations by panel members 


1:00 p.m. Lunch (NBS Cafeteria) 

2:00 p.m. Parallel Sessions A, B, and C 

Discussion between panel members and 
audience 


Session Chairman - Robert E. Head 

Assistant Director, 

Systems Development 
Automated Data Systems 
U.S. Department of Agriculture 

Topics: 

Can the guidelines help? 

How can the manager evaluate technical documentation? 
Is documentation worth the cost? 

How can software quality be assured thru documentation? 
Do existing systems need to be documented? 


Session B - ADP Systems, Operations, and Programmer 

Personnel 

Session Chairman -Thomas P. Giammo 
Director, 

Division of Statistical Processing 
OMA 

Social Security Administration 
U.S. Department of Health, Education & 
Welfare 

Topics: 

How does the Functional Description help programmers and 
users? 

Why does the System Specification permit more accurate 
time and resource estimates? 

How does the Program Maintenance Manual help imple- 
ment system changes? 

How does the User Manual provide better "customer 
relations"? 


Session C - Standards, Training, Policy, and Audit 
Personnel 

Session Chairman - Harris G. Reiche 
Director, 

Office of ADP & Telecommunications 
Management 

U. S. Department of the Interior 


3:00 p.m. Parallel Sessions A, B, and C 

Session summary and conclusion 


Topics: 

How does one convert the guideline to (one or more) agency 

3:30 p.m. Adjourn standards? 

What kind of user and programmer training is needed to use 
the guideline/standard? 

How does the internal auditor measure performance against 
each document type? 

How does the external auditor compare systems objectives 
and completed software? 
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The planning, design, development, and implementation of 
computer programs and automated data systems (software) 
represent a considerable investment of human and automated 
resources. To maximize the return on this investment, and to 
provide for cost-effective operation, revision, and mainte- 
nance, sufficient documentation is needed at each stage of the 
software development life cycle. FIPS PUB 38 has been pre- 
pared to provide government-wide guidelines in response to 
that need. This symposium has been organized to introduce 
the government ADP community to the concepts of FIPS PUB 
38. 


OBJECTIVE 

The attendee should come away from this symposium with a 
fuller understanding of when and how to apply these govern- 
ment-wide guidelines, in developing either: 

• Agency standards, or 

• Operational documentation 


SESSIONS 

This symposium will be organized into a plenary session 
followed by three concurrent panel sessions. The plenary 
session will provide an overview and philosophy of FIPS PUB 
38. The parallel panel sessions will focus on those aspects 
relevant to particular interests: 

• Management 

• Operations 

• Staff 

A summary of the proceedings of all three panel sessions will 
be mailed to all attendees as soon as possible following the 
symposium. 


Technical managers, standards specialists, systems analysts, 
computer programmers, and others with an interest in docu- 
mentation standards are eligible for nomination. Nomination 
for Federal and military personnel should be submitted on 
Optional Form 170, Optional Form 37 or other agency 
approved training authorization form. Please attach the regis- 
tration form included in this announcement. State, city and 
other local governments, as well as other eligible organiza- 
tions, may nominate their personnel by letter from an author- 
ized official which must include the following information: your 
name, title, symposium date, which sessions, employee name, 
annual salary, position title, billing address, and the address 
and telephone number of the office to which the confirmation 
notice should be forwarded. All nominations should be sent to 
the Director, The ADP Management Training Center, U.S . Civil 
Service Commission, 1900 E Street, N.W., Attn: TOA. 
Washington, D C., 20415, by the nomination deadline dates 
shown in the calendar. Further information may be obtained 
by calling (202) 632-5650 or code 101 extension 25650. 


COST 

The cost of the seminar is $20 per person for nominations re- 
ceived by September 24, 1976 and $25 for nominations re- 
ceived after that date. Agencies will be billed for all accepted 
nominees unless formal cancellations are received by the 
close of business October 4, 1976. A control numberfrom our 
cancellation register must be secured for each cancellation 
requested. Substitutions of eligible participants may be made 
up to the beginning of the program. 

Luncheon, a copy of FIPS PUB 38, and a summary of the pro- 
ceedings are included in the fee. Additional copies of the pro- 
ceedings will be made available through the National Tech- 
nical Information Service. 


Symposium for Documentation of Computer Programs and Automated Data Systems 

REGISTRATION CARD 
October 12, 1976 


Name 

(Please Print) LAST FIRST MIDDLE 

Agency Telephone 


City State Zip 

□ Pre-registration $20 (if nomination received by Sept. 24) □ Late nomination $25 (after Sept. 24) 

D Proceedings only (you will be notified by NTIS when proceedings are available) 

Please return this card with your nomination form to: Director 

The ADP Management Training Center 
U.S. Civil Service Commission 
1900 E Street, N. W. 

ATTN: TOA 

Washington, D. C. 20415 

Please circle your tentative session preference. ABC 
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The registration desk will be open in the hall opposite the When: 

Green Auditorium, National Bureau of Standards, Gaithers- 
burg, MD beginning at 8:30 a.m. Ample free parking is available Nomination Deadline: 

at the NBS facility. Follow the signs to Visitors Parking. Out of 

town registrants should make their own arrangements for Cancellation Deadline: 

lodging. 

Registration: 


October 12, 1976 

September 24, 1976 

October 4, 1976 

Tuesday October 12, 1976 
8:30 am - 9:30 am 


FURTHER INFORMATION 

For technical information on the Symposium for Documenta- 
tion of Computer Programs and Automated Data Systems, call 
the Symposium Chairman, Mr. Mark Silverman at (703) 
860-7177. 


Program: 

Location: 


9:30 am - 3:30 pm 

Green Auditorium 
Administration Building 
National Bureau of Standards 
Gaithersburg, Maryland 


SYMPOSIUM COMMITTEE 

Mark Silverman (Chairman) 

U. S. Geological Survey 

Roy Young 

U. S. Department of Health, Education & Welfare 
Mitchell Krasny 

National Technical Information Service 

Beatrice Marron 

National Bureau of Standards 

Fred Rao 

U. S. Civil Service Commission 


CST 24-T367 
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